id es el UUID de Fire spark.
Requiere un access token con el scope
payments:read. Consulta
Token para obtener un token.Parámetros de ruta
| Parámetro | Obligatorio | Descripción |
|---|---|---|
id | Sí | UUID del pago en Fire spark. |
Solicitud
curl "https://firespark.cloud/api/integrations/v1/payments/3b1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90" \
-H "Authorization: Bearer ACCESS_TOKEN"
Respuesta
La respuesta envuelve un pago endata. Los secretos se quitan de config.
{
"data": {
"id": "3b1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
"payment_provider_id": "6f1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
"payment_method_id": "7c1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
"config": { "public_key": "pk_test_123" },
"rules": [{ "minimum_order_value": 5, "maximum_order_value": 200 }],
"conditions": [
[
{
"primitive": "currency",
"type": "Order total",
"operator": "greater than or equal to",
"value": 10
}
]
],
"store_ids": null,
"channel_ids": ["app"],
"brand_ids": null,
"fulfillment_ids": null,
"store_label_ids": null,
"channel_label_ids": null,
"brand_label_ids": null,
"fulfillment_label_ids": null,
"status": "ACTIVE",
"provider": {
"id": "6f1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
"provider_id": "kushki",
"name": "Kushki",
"logo_url": null
},
"method": {
"id": "7c1c8f2e-5a44-4d1b-9c0e-2f6a1d8b7e90",
"method": "CARD",
"name": "Card",
"version": "1.0.0"
}
}
}
Objeto de pago
| Campo | Tipo | Descripción |
|---|---|---|
id | string (UUID) | Identificador del pago en Fire spark. |
payment_provider_id | string (UUID) | Fila del proveedor en el catálogo. |
payment_method_id | string (UUID) | Fila del método en el catálogo. Debe pertenecer a ese proveedor. |
config | object | Credenciales del proveedor, sin private_key ni webhook_signature. En firespark REDEMPTION, el logo_url opcional de la fuente del canje. |
rules | array | Ventanas de total del pedido. Ver Crear o actualizar pagos. |
conditions | array | OR de grupos AND. Ver Crear o actualizar pagos. |
store_ids, channel_ids, brand_ids, fulfillment_ids | array o null | Ids externos. null significa todos los ids de ese tipo. |
store_label_ids, channel_label_ids, brand_label_ids, fulfillment_label_ids | array o null | UUIDs de etiquetas. null significa todas las etiquetas. |
status | string | ACTIVE o INACTIVE. |
provider | object | id, slug provider_id, name, logo_url. |
method | object | id, method (CASH, CARD, BANK_TRANSFER, WALLET, PIN_PAD), name, version. |
Respuestas de error
| Estado | Descripción |
|---|---|
401 | Access token ausente o inválido |
403 | El token no incluye payments:read |
404 | No existe un pago con ese id |